Custom damage code mapping

You can upload your terminal's custom damage codes for use in the N4 Mobile forms when recording container damages. A custom damage code is a code that is mapped to an existing damage type, severity, and location in N4. Once uploaded, you can enter custom damage codes in the N4 Mobile forms. This saves you time since you enter one code instead of specifying the damage type, severity, and location for each damage.

If you upload custom damage codes, N4 automatically changes the layout of various N4 Mobile container damage forms to allow entry of the custom damage codes.

To implement custom damage codes:

1. Define the custom damage code mapping in an XML file with the following format:

<?xml version="1.0" encoding="UTF-8"?>

<damageTypes>

    <damageType id="<code>" severity="<MINOR/MAJOR>" location="<location>"/>

</damageTypes>

• The damage type must be a valid ID in the Damage Types view (on page 1).

• The severity attribute must be either MINOR or MAJOR in all upper case letters.

• The location attribute must be a valid ID in the Damage Components view (on page 1).

2. In the Settings view, upload your XML file as follows:

1. Double-click the ROADGATE008 (DAMAGE_TYPE_CODE_XML) setting to open the Edit Configuration form.

2. In the Scope block, select Global.

3. In the Global Setting block, click Override. This enables Import File in the Global Setting block.

If the Override button is not available, click Clear in the Global Setting block.

4. Click Import File to open the Import XML Configuration form.

5. Browse to select the .xml file that contains your custom damage codes.

6. Click Save.

The Import XML Configuration dialog closes and N4 imports your .xml file.

3. Reset the cached damage code mapping for a rebuild as follows:

1. Login to N4 Mobile as a user with the Mobile Applications Management privilege.

2. Click Reset to clear the cached damage code mapping.

3. Log out and log back in as a normal user.

N4 Mobile caches the new damage code mapping when you access any of the applications for the first time.

The following is an example XML file with three custom damage codes:

<?xml version="1.0" encoding="UTF-8"?>

<damageTypes>

<damageType id="01" severity="MINOR" location="FRONT"/>

<damageType id="02" severity="MINOR" location="AFT"/>

<damageType id="03" severity="MAJOR" location="BOTTOM"/>

</damageTypes>